Release 10.1A: OpenEdge Development:
Progress 4GL Handbook

Navigating the hierarchy of menu handles

For both menus and submenus, your procedure code can traverse all the menu items and nested submenus. The FIRST-CHILD attribute of a menu or submenu returns the handle of its first menu item or child submenu. The NEXT-SIBLING attribute of each menu item or submenu returns the handle of the next object at that level. Object handles are returned in left-to-right order for sibling submenus, and top-to-bottom order for menu items. You can navigate in reverse by starting with the LAST-CHILD attribute and following the PREV-SIBLING chain. These attributes are readable only. Their values are established when you assign parents to each submenu and menu item.

You can also add dynamic submenus and menu items to an existing static menu. To do this, navigate the menu using these CHILD and SIBLING attributes to locate the handle of the object in the menu where you want to attach another submenu or menu item. Create the new objects and parent them to the existing object. You can parent a new submenu to the menu bar or to another submenu. You can parent a new menu item to an existing submenu. New objects are added to the end of the list of current objects at that level (that is, to the right of existing submenus in a parent menu or submenu) or to the bottom of the list of menu items for a submenu.